Release Notes

• Onboarding guidance for restricted “Display over other apps”: When Android blocks enabling the overlay permission via restricted settings, users are shown an instructional “Enable restricted settings” dialog instead of an immediate error.
• Step-by-step App Info instructions: Introduced OverlayPermissionGuide.showRestrictedSettingsDialog(context) to display localized, ordered steps and a button to open the app’s App Info screen so users can manually enable the restricted overlay toggle.
• Lifecycle-aware follow-up after permission request: Updated PermissionsFragment to only run the post-overlay-permission UI flow when the overlay grant request was initiated, and to show the restricted-settings dialog when the fragment is resumed and overlay permission is still not granted.
• New user-facing copy: Added strings and an instruction array for the restricted-settings dialog and its “Open App info” action.

Risks & Best Practices Violations

• ⚠️ Shared mutable state: awaitingOverlayGrantResult is stored in PermissionsFragment’s companion object, making it shared across fragment instances and potentially problematic if multiple instances exist or recreate during onboarding.
• ⚠️ Runtime Activity type check for intent flags: Uses context !is Activity to decide whether to add FLAG_ACTIVITY_NEW_TASK; works, but relies on runtime type behavior rather than more explicit context/activity handling.

Walkthrough

Adds a new OverlayPermissionGuide dialog flow for restricted overlay settings. PermissionsFragment now waits for the overlay result, then shows the guide on resume when overlay permission remains unavailable. New strings provide the dialog copy and setup steps.

Changes

Overlay Permission Restricted Settings Guide

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• appdevforall/CodeOnTheGo#1035: Modifies the same overlay-permission follow-up flow in PermissionsFragment, including awaitingOverlayGrantResult and handlePostOverlayPermissionState.
• appdevforall/CodeOnTheGo#1157: Touches the same post-denial overlay path that routes users toward app-details/settings handling.
• appdevforall/CodeOnTheGo#1168: Relates to the same “Display over other apps” onboarding and permission-granting flow.

Suggested reviewers

• jatezzz
• itsaky-adfa
• dara-abijo-adfa

Poem

🐇 Hop hop, the overlay tale is new,
A guide with steps and buttons too.
If Android says “no,” the rabbit says “go,”
To App Info’s door, where permissions grow.
A tiny bounce, a helpful glow ✨

❌ Failed checks (1 warning, 1 inconclusive)

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

• X
• Mastodon
• Reddit
• LinkedIn